Crate dotproperties [] [src]

A crate to parse the Java Properties file format.

The Properties file format is simple key/value text format that can be read and written by the standard library of Java. It is often used for configuration files, and also for translation files (Bundles).

The Java class that supports this format is java.util.Properties, with its methods load and store. Note that the Java class also provides the methods loadFromXML and storeToXML, but this crate does not support the XML format.

Starting from Java 9, the Properties files used as Resource Bundles are allowed to be utf-8, instead of only latin1 with unicode escapes (JEP 226). This crate does not support JEP 226.

This crate was written based on the Java 8 API reference. As far as the author knows, this crate supports reading the full Properties format with no exception. There is no support to write Properties files, yet.

Structs

Error

A parsing error

Functions

parse_from_file

Parse the file and return a vec of key/value pairs. The order of the elements in the parsed content is preserved.

parse_from_slice

Parse the bytes and return a vec of key/value pairs. The order of the elements in the parsed content is preserved.